<!DOCTYPE HTML>
<html>
<head>
<title>Suspend | AutoHotkey</title>
<meta name="description" content="The Suspend command disables or enables all or selected hotkeys and hotstrings." />
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
</head>
<body>

<h1>Suspend</h1>

<p>禁用或启用所有的或选择的<a href="../Hotkeys.htm">热键</a>和<a href="Hotstrings.htm">热字串</a>.</p>

<pre class="Syntax"><span class="func">Suspend</span> <span class="optional">, Mode</span></pre>
<h2 id="Parameters">参数</h2>
<dl>

  <dt>Mode</dt>
  <dd><p><strong>On</strong>: 挂起所有的<a href="../Hotkeys.htm">热键</a>和<a href="Hotstrings.htm">热字串</a>, 备注部分说明的除外.</p>
      <p><strong>Off</strong>: 重新启用上面禁用的热键和热字串.</p>
      <p><strong>Toggle</strong>(默认): 改变为与原来相反的状态(On 或 Off).</p>
    <p><strong>Permit</strong>: 仅仅把当前的子程序标记为免于挂起.</p>
    <p><span class="ver">[v1.1.30+]:</span> 值 1(或 <code>true</code>), 0(或 <code>false</code>) 和 -1 可以分别用来代替 On, Off 和 Toggle.</p>
    </dd>

</dl>

<h2 id="Remarks">备注</h2>
<p>默认情况下, 脚本也可以通过它的<a href="../Program.htm#tray-icon">托盘图标</a>或<a href="../Program.htm#main-window">主窗口</a>来挂起.</p>
<p>任何首行为 Suspend(不包括 <code>Suspend On</code>) 的热键/热字串会被免于挂起. 换句话说, 即使在挂起状态为 ON 时热键仍会保持可用. 这样就允许使用这样的热键关闭挂起状态.</p>
<p>如果由该命令进行更改, 则将安装或删除<a href="_InstallKeybdHook.htm">键盘</a>和/或<a href="_InstallMouseHook.htm">鼠标</a>钩子.</p>
<p>要根据窗口的类型自动禁用选择的热键或热字串, 请使用 <a href="_IfWinActive.htm">#IfWinActive/Exist</a>.</p>
<p>挂起脚本的热键不会停止脚本中已经运行的<a href="../misc/Threads.htm">线程</a>(如果有), 请使用 <a href="Pause.htm">Pause</a> 来让它停止.</p>
<p>当脚本的热键挂起时, 它的托盘图标会变为字母 S. 这可以通过冻结图标来避免, 这是使用最后一个参数为 1 的 Menu 命令实现的. 例如:</p>
<pre><a href="Menu.htm">Menu</a>, Tray, Icon, C:\My Icon.ico, , 1</pre>
<p>当脚本挂起时内置变量 <a href="../Variables.htm#IsSuspended">A_IsSuspended</a> 值为 1, 否则为 0.</p>
<h2 id="Related">相关</h2>
<p><a href="_IfWinActive.htm">#IfWinActive/Exist</a>, <a href="Pause.htm">Pause</a>, <a href="Menu.htm">Menu</a>, <a href="ExitApp.htm">ExitApp</a></p>
<h2 id="Examples">示例</h2>
<div class="ex" id="ExHotkey">
<p><a class="ex_number" href="#ExHotkey"></a> 按下一次热键可暂停所有热键和热字串. 再按一次可取消暂停.</p>
<pre>^!s::Suspend  <em>; Ctrl+Alt+S</em></pre>
</div>

<div class="ex" id="PostMessage">
<p><a class="ex_number" href="#PostMessage"></a> 发送 Suspend 命令到另一个脚本.</p>
<pre><a href="DetectHiddenWindows.htm">DetectHiddenWindows</a>, On
WM_COMMAND := 0x0111
ID_FILE_SUSPEND := 65404
<a href="PostMessage.htm">PostMessage</a>, WM_COMMAND, ID_FILE_SUSPEND,,, C:\YourScript.ahk ahk_class AutoHotkey</pre>
</div>

</body>
</html>